支持多语言（插件）

该方案依赖我向上游提交的一个 PR 其作用是使 UI 语言能够优先依据 page.locale 进行判断。

• Support resolving ui-text using page.locale when available mmistakes/minimal-mistakes#5368

介绍

二级后缀自动作为 page.locale

插件会根据文件名的二级后缀为文章指定 page.locale 详情如下：

1. 在 _config.yml 中配置字符串类型参数 locale 作为系统的默认语言区域代码
2. 在 _config.yml 中配置字符串数组类型参数 locales 例如 locales: [zh-Hans, zh-Hant, en] 表示支持的语言区域代码列表，其中可以省略默认语言区域代码

插件会在 site pre_render 时期遍历所有页面 Page 与文档 Document 并根据文件名结合上面两个参数判断当前文档的语言区域代码。以配置 locale: zh-Hans 与 locales: [zh-Hant, en] 为例 index.md index.es.md 的文件名中均未命中配置列表中受支持的代码，因此使用默认代码 zh 作为 page.locale 而 help.en.md 与 faq.zh-Hant.md 会分别使用 en 与 zh-Hant 作为 page.locale 。

自动配置多语言页面 page.permalink

插件要求内容必须存在默认语言版本，无默认语言版本的内容不会被插件处理，等价于 i18n: false 配置。

插件会根据默认语言页面的 page.permalink 自动为多语言页面配置 page.permalink 为 /{locale}/{default_permalink} 假设 /test/a.md 对应的 page.permalink 为 /test-a.html 那么 /test/a.en.md 对应的 page.permalink 则为 /en/test-a.html 。

为不存在的语言版本提供回退页面

如果一篇文章并没有完整的支持所有的语言版本，在用户访问不存在的语言版本页面时用户会看到一个回退页面而非 404 页面。用户可以通过 _data/plugins/i18n/fallback.yml 文件配置回退规则，详情如下：

# 若 lzh 版本页面不存在，则回退使用 zh-Hant 版本
lzh: zh-Hant

# 回退规则支持嵌套：
# 若 lzh 与 zh-Hant 版本页面均不存在，则使用 zh-Hans 版本页面回退
zh-Hant: zh-Hans

# 对未配置回退规则的语言区域代码，使用默认语言区域代码作为回退

其它

需要启用多语言的页面需要配置 i18n: true 如下所示：

---
title: xxx
i18n: true
---

xxx

待做清单

多语言支持

• 颜色模式切换器
• 预览构建信息
• 站点信息
  部分完成，已支持 site.title site.description site.date_format
• 署名信息
• 404 页面
• 语言切换器
• 自动生成的页面
  部分完成，已支持 feed sitemap
• 多语言页面锚点支持相互转化
  /test.html: #帮助
  /en/test.html: #help
• 链接站内多语言文章优先使用与本文相同语言的链接
  /test.html: [demo](/_docs/demo.md) => /demo.html
  /en/test.html: [demo](/_docs/demo.md) => /en/demo.html

待合并 PR 的多语言支持

• 支持 GitHub 风格的 Markdown 提示块（Alert）语法 #344

其它

• 集合内容的上一页与下一页按钮会切换到非当前语言的内容

关联 ISSUES

• 适配多语言 #189

预览